home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / 300last.zip / 300LAST.DOC < prev    next >
Text File  |  1992-08-09  |  9KB  |  199 lines
  1.  
  2.                                   300 LAST
  3.                      =================================
  4.                        version 1.05 released 8/09/92
  5.  
  6.         A public domain SysOp utility from the Charlatan's Cabin BBS
  7.                  for SysOps of Wildcat! version 3.0x ONLY.
  8.  
  9.              See VERSION HISTORY at the end of this document.
  10.  
  11. WHAT IT DOES:
  12. -------------
  13. 300LAST generates and automatically "trims" a listing of your most recent
  14. callers.  If enabled, it will include Wildcat! automatic color codes in
  15. any of its display files.
  16.  
  17. HOW IT WORKS:
  18. -------------
  19. Each time a caller logs off from one of your nodes, the file NODEINFO.DAT
  20. is updated to contain the caller's name, city, and time/date of logoff.
  21. 300LAST is run immediately after each logoff ... we'll explain how to do
  22. that in a moment.
  23.  
  24. The 300LAST.CFG (configuration file) tells 300LAST where to find certain
  25. files and what output files to write.  Only ONE copy is required, anywhere
  26. in your DOS path.
  27.  
  28. The program determines the node number by first checking to see if the
  29. environment variable "WCNODEID=" is set.  If so, it uses that value.  If
  30. not, it next looks for DOOR.SYS in the current directory.  Remember that
  31. Wildcat! will place you in the appropriate NODE WORK directory when you
  32. shell out, and DOOR.SYS will be written there, too.
  33.  
  34. The program gathers the data, places it at the FRONT of the caller log,
  35. so that the most recent calls are first, and writes the output file(s).
  36. If the file has accumulated the configured maximum number of callers, 
  37. then the entry at the end of the file (the oldest call) will be deleted, 
  38. so you never have to trim the output file by hand.
  39.  
  40. Any caller may view this log at any time if you set it up as a bulletin.
  41.  
  42. Remember that when you first start using 300LAST there will be only a few
  43. calls until the list builds up ... so you might wish to start it a day or
  44. two before you announce the fact that the files are available for viewing.
  45.  
  46. INSTALLATION:
  47. -------------
  48. Installing the program is easy.  
  49.  
  50. 1.   Place 300LAST.EXE anywhere in your path so it can be run 
  51.         from any directory.  The program requires BRUN40.EXE
  52.         which you almost certainly already have.  If not, it's
  53.         widely available, including my BBS ... see below.
  54.  
  55. 2.   In your STARTUP directory, create a file called POSTCALL.BAT. Wildcat!
  56.      will automatically detect it (or POSTCALL.RUN in the work directory ...
  57.      see your Wildcat! documentation)
  58.  
  59.      Here's a sample of what it should say:
  60.  
  61.      echo off
  62.      300LAST
  63.      exit
  64.  
  65.      The "EXIT" line isn't actually required, but it's a safe way to ensure 
  66.      that the shell will properly release control to Wildcat! if something 
  67.      goes wrong.  
  68.  
  69.      IMPORTANT:  If you have MAKEWILD set to TERMINATE instead of SHELL, 
  70.      you must create individual files named POSTCALL.RUN in each of your
  71.      node work directories.  The last line of each one must be changed from
  72.      'exit' as shown above to the name of the batch file to start the
  73.      particular Wildcat! node.  Refer to the Wildcat! documentation for more
  74.      details on SHELL and TERMINATE options ... 
  75.  
  76. 3.   Run MAKEWILD and make sure whether you're set to SHELL or TERMINATE, then
  77.      review step 2 above.
  78.  
  79. 4.   Anywhere in your DOS path, you'll create  300LAST.CFG.  Here's an
  80.      example of 300LAST.CFG ... this one would be for use on NODE 2, and
  81.      it would be placed in the \WC30\WCWORK\NODE2 directory:
  82.  
  83. BBSNAME=The Charlatan's Cabin BBS
  84. NODEINFO=C:\WC30\DATA\NODEINFO.DAT
  85. SAVEFILE=C:\WC30\300LAST.DAT
  86. KEEPER=300
  87. EXCLUDE=MICHAEL CONLEY
  88. WRITE=C:\WC30\WCPRO.BBS /SHOWNODE /CLS /COLOR
  89. WRITE=C:\WC30\BULL\BULL22.BBS /SHOWNODE /CLS /COLOR
  90.  
  91.         Leave NO blank lines above these entries -- the program
  92.         imports each one based upon its line number in this file.
  93.  
  94.         Line 1 BBSNAME=  is the name of your BBS for the listing header,
  95.                          e.g., BBSNAME=The Charlatan's Cabin BBS
  96.  
  97.         Line 2 NODEINFO= is the Drive and PathName to the node information 
  98.                          file, e.g., NODEINFO=C:\WC30\DATA\NODEINFO.DAT
  99.  
  100.         Line 3 SAVEFILE= is the Drive and PathName of the file 300 LAST will 
  101.                          use to keep a reference copy of the callers list.
  102.                          It will be maintained automatically by 300 LAST.
  103.                          e.g., SAVEFILE=C:\WC30\300LAST.DAT
  104.  
  105.         Line 4 KEEPER=   tells the program how many callers to keep.  Any
  106.                          value from 2 to 300 is valid here, e.g., KEEPER=300
  107.  
  108.         Line 5 EXCLUDE=  tells the program any names (such as the sysop) to
  109.                          exclude from the listings.  If you don't want to
  110.                          exclude anyone, put EXCLUDE=NONE on this line.
  111.  
  112.        Lines 6  - 300    name the output files.  They will ALL be written 
  113.                          if there is new "last caller."  The format is
  114.                          important -- see below:
  115.  
  116.        Each line MUST begin with the phrase "WRITE=" followed by a
  117.        valid COMPLETE DOS drive/path/filename.  Any number of these 
  118.        filenames (up to 300) are executed by the program.  After the
  119.        filename, leave a space and then any combination of the available
  120.        switches:  
  121.  
  122.           /SHOWNODE  will include the Node number in the listing in the 
  123.                      display file.
  124.  
  125.           /CLS       will place a Wildcat! clear-screen code at the front of 
  126.                      the display file.
  127.  
  128.           /COLOR     will cause Wildcat! automatic color codes to be generated.
  129.                      If the caller is not ANSI-compatible, these color codes
  130.                      will NOT be displayed.  In that way, one ".BBS" file will
  131.                      suffice for BOTH your COLOR and your MONO callers.
  132.  
  133. OPTIONAL APPROACH:
  134. ------------------
  135.      If you'll be using WCPRO to generate a BULLETIN instead of the 
  136.      [S]tatistics display for the main menu, or if you don't plan 
  137.      to run WCPRO's statistics function at all, you might do this:
  138.  
  139.      Run MAKEWILD and edit the MAIN MENU so that the default "S" command 
  140.      (system statistics) becomes something like [L]...Log of recent callers.
  141.      Be sure to change the "hot key" letter on the menu definition page to
  142.      whatever letter you select.
  143.      
  144.      Change the 300LAST.CFG file to create WCPRO.BBS in the startup 
  145.      directory:
  146.  
  147.                      WRITE=c:\wc30\WCPRO.BBS 
  148.  
  149.        ... and add whatever other bulletins you wish to write ...
  150.  
  151.      (make whatever changes are required for your pathnames, and
  152.       as before, be sure to use the correct node number in each
  153.       config file.
  154.  
  155. You may include up to 300 WRITE= commands in the configuration file.
  156.  
  157.  
  158. Problems, questions, suggestions:
  159. ---------------------------------
  160. If you get a message from 300LAST saying something like
  161.  
  162.                    FILES IN USE - Retry ## of 50
  163.  
  164. this means that 300LAST thinks that another copy of 300LAST is running
  165. on another node.  If that's NOT TRUE, then it accidentally left over a
  166. file called "300LAST.PUK" in your C:\ directory.  You can FORCE the
  167. program to execute by typing an 'F' at this time.  It should start within
  168. 5 seconds after you press the 'F' key.
  169.  
  170. PROBLEMS, SUGGESTIONS:
  171. ======================
  172. 300LAST is public domain.  I don't seek or accept any donations for this or
  173. any of my other Wildcat! utility programs, including TODAYBBS, FLOP, MSTAT,
  174. USTAT, and others.
  175.  
  176. I welcome suggestions, and will try to help (no guarantees) if there are
  177. problems.
  178.  
  179. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  180. your Wildcat! registration number in the comment and you'll be upgraded to
  181. membership without the usually required registration by mail.
  182.  
  183. You may also leave a message via CompuServe (70250,220).
  184.  
  185. Please, NO VOICE CALLS.  This isn't meant to be unfriendly, but with
  186. the price of public domain software these days ... I just can't afford
  187. to be "on call."  I WILL respond to your questions via my BBS or CompuServe,
  188. or via the Mustang Software registered SysOp BBS.
  189.  
  190. VERSION HISTORY:
  191. =================
  192. 1.00    Compiled  8/01/91    First release version for Wildcat! 3.0
  193. 1.01    Compiled  9/07/91    Removed audible warnings if file access denied.
  194. 1.02    Compiled  9/29/91    Improved duplicate detection if node received
  195.                              a call but nobody logged on.
  196. 1.05    Compiled  8/09/92    Added reporting of LOCAL logons unless the
  197.                              caller's name is in the EXCLUDE list.      
  198.  
  199.